home *** CD-ROM | disk | FTP | other *** search
/ Software 2000 / Software 2000 Volume 1 (Disc 1 of 2).iso / utilities / u258.dms / in.adf / UserDocs / Manual_Pages / Dir < prev    next >
Encoding:
Text File  |  1988-02-12  |  4.8 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      Dir(REL2)             ARP User's    Manual             Dir(REL2)
  5.  
  6.  
  7.  
  8.      NAME
  9.       Dir -    Display    a sorted, formatted display of files on    a
  10.           disk.
  11.  
  12.      SYNOPSIS
  13.       DIR -    OPT/K {    ADFHIS } ALL/S DIRECT/S    FILES/S    HILITE/S
  14.           INTER=INTERACT/S SIZE/S
  15.  
  16.      DESCRIPTION
  17.       Dir by itself    displays any files and directories in the
  18.       current directory.  By default, Dir will display any
  19.       subdirectories, one per line,    in sorted order, and then any
  20.       files, in two    columns, also in sorted    order.    Directories
  21.       are followed by the string "(dir)".
  22.  
  23.       You may also specify a directory as an argument to Dir.  The
  24.       BCPL directory had difficulties with wildcards and
  25.       filenames, but the ARP Dir handles these with    ease. If you
  26.       specify a directory name, Dir    will generate a    listing    of
  27.       that directory. If instead, you specify a filename, Dir will
  28.       simply echo that filename, if    it finds it on the disk.
  29.  
  30.       If you use wildcards in the directory    argument, the display
  31.       is somewhat different.  If the wildcard pattern you supply
  32.       matches a directory, then the    full name of the directory,
  33.       along    with the string    "(dir)"    will be    displayed.  After
  34.       that,    in sorted order, will be the contents of that
  35.       directory.  This will    occur for any directories which    match
  36.       the pattern you specified.  If the wildcard pattern matches
  37.       any files, they will be displayed to the screen as well.
  38.  
  39.      OPTIONS
  40.       The ARP Dir command supports all the options of the original
  41.       BCPL Dir, and    several    more as    well.  Using the ARP Dir
  42.       command, you can use the keyword OPT,    and then the single
  43.       letter which represents the option you desire, or you    may
  44.       use the clearer keyword equivalents supplied.     The options
  45.       and their keyword equivalents    are described below:
  46.  
  47.       ALL (OPT A):      This generates a complete sorted and
  48.               formatted listing of the files and
  49.               subdirectories in the    specified branch of
  50.               the directory    tree.  You may use other
  51.               options or keywords along with ALL to
  52.               generate the display you need.  Each new
  53.               directory will cause an additional level of
  54.               indentation to be added, making the
  55.               directory organization clearer to the    eye.
  56.  
  57.       DIRECT (OPT D): This causes Dir to generate a    listing
  58.               consisting only of directories. When used
  59.               with the ALL or OPT A    directive, all
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 2/22/88)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      Dir(REL2)             ARP User's    Manual             Dir(REL2)
  71.  
  72.  
  73.  
  74.               directories in that branch of    the directory
  75.               tree will be displayed.
  76.  
  77.       FILES    (OPT F):  This causes Dir to generate a    sorted listing
  78.               consisting only of files.  The ALL keyword
  79.               or OPT A has no effect on this option, but
  80.               it may usefully be combined with others,
  81.               such as the SIZE directive, to be discussed
  82.               below.
  83.  
  84.       HILITE (OPT H): This enables pretty printing of Dir's
  85.               output. All directory    names will be
  86.               displayed in inverse video.
  87.  
  88.       SIZE (OPT S):      This displays    the size of all    files found,
  89.               in bytes.  If    a directory is found, it is
  90.               identified with the string "(dir)", as
  91.               usual.
  92.  
  93.       INTER=INTERACT (OPT I):
  94.               This allows interactive file browsing
  95.               through a directory or a disk.  You can use
  96.               other    options, such as ALL, with this    one.
  97.               Using    this option, you will be presented
  98.               with a file or directory name, followed by a
  99.               question mark.  If the name displayed    is a
  100.               directory, identified    in the usual way with
  101.               "(dir)", or by inverse video if you selected
  102.               the HILITE option, you may enter the
  103.               directory by typing E.  If the directory is
  104.               empty, you may delete    it by typing DEL. You
  105.               can move back    up the directory tree at any
  106.               time by entering B. If the directory you are
  107.               in has no parent, typing B will exit the Dir
  108.               program. To advance to the next entry,
  109.               simply press Return.
  110.  
  111.               If the name displayed    is a File, you may
  112.               view the file    by entering T, for "Type", you
  113.               may delete the file using the    DEL keyword,
  114.               and you may advance to the next entry    by
  115.               pressing Return. You can also    move up    the
  116.               directory tree by entering a B, but you must
  117.               be at    a directory entry to descend the tree.
  118.  
  119.               You can exit the interactive mode of Dir at
  120.               anytime by typing Q. If you forget any of
  121.               these    options, online    help is    available by
  122.               typing '?', as usual.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 2/22/88)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      Dir(REL2)             ARP User's    Manual             Dir(REL2)
  137.  
  138.  
  139.  
  140.      EXAMPLE
  141.       To get a listing of all directories on drive DF1:
  142.  
  143.           DIR DF1: ALL DIRECT
  144.       or
  145.           DIR DF1: OPT AD
  146.  
  147.       To get a listing of all directories and files    and the    sizes
  148.       of the files on drive    df0:, as well as displaying the
  149.       directories in inverse video do:
  150.  
  151.          DIR DF1: ALL SIZES HILITE
  152.       or
  153.          DIR DF1: OPT ASH
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 2/22/88)
  196.  
  197.  
  198.  
  199.